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ABSTRACT 



The Naval Postgraduate School’s (NPS) Space Systems Academic Group (SSAG) 
is currently developing the Petite Amateur Navy Satellite (PANSAT). This thesis 
describes the PANSAT Software Groundstation development and design. This covers 
requirements that led to various design decisions as well as the use of the Groundstation 
Software and the programming background necessary to provide detailed information of 
how to enhance this software in the future. Furthermore, it can be considered as a brief 
manual for the development of software other than the Groundstation with the high-level 
programming language C++. 

The Groundstation Software is designed to run under Windows 3.x® or 
Windows NT® operating systems on an IBM-compatible PC. It allows an easy visual 
access to all command and control features incorporated in the PANSAT design via the 
PANSAT Command Language (PCL). The software design provides full control over the 
additional hardware necessary to physically establish a connection to PANSAT, by 
plugging it into the serial port of the PC running the Software Groundstation. 

The data structures and the visual controls are designed to meet the requirements 
of usability, flexibility and compatibility to third-party software. In addition, the use of 
data encapsulation as a typical feature of the programming language C++ ensures 
readable source code. 
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I. INTRODUCTION 



A. THE PANSAT PROJECT 

The PANSAT project was initiated in 1989 as an educational program for student 
officers at the Naval Postgraduate School’s (NPS) Space Systems Academic Group 
(SSAG). It was intended to prepare postgraduate students for space related tasks as well 
as to develop a cadre of engineers capable of developing and actually producing space 
qualified hardware. 

PANSAT is a small satellite for digital store-and- forward communications in the 
amateur frequency band. It features a direct sequence spread spectrum differentially 
coded, binary phase shift keyed (BPSK) communication system at an operating frequency 
of 436.5MHz. This adds a new dimension to amateur radio communication, as spread 
spectrum capability has never been used before in that context. The store-and-forward 
capability will allow amateur radio operators to send or receive messages during several 
short communication windows every day, each 6 to 10 minutes of length. 

The whole PANSAT structure weighs approximately 150 pounds, has a diameter 
of about 19 inches, and is being designed to launch as a secondary 7 payload from the 
Space Shuttle as part of the Hitchhiker Program. It is made of aluminium 6061-T6 and 
built around a main load bearing cylinder connected to the lower equipment plate; a 26- 
sided polyhedron was the chosen configuration to maximize solar panel area and thus 
power generation. PANSAT will be unstabilized and tumble freely, once put into space 
with a Get Away Special (GAS) container. Its operational life is expected to be two years 
at an inclination between 28.5° and 51.6° and an altitude between 160 and 220 nautical 
miles. 
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B. THE PANSAT GROUNDSTATION 



Once PANSAT is in space, the only means to access it is via radio control. This 
shall include both commanding and gathering telemetry. Because PANSAT’s hardware 
capabilities require commanding structure of a relatively high complexity, the problem of 
dealing with the correct sequence of all possible commands, their correct timing as well 
as telemetry storage and -maintenance becomes apparent. The most convenient way for 
PANSAT users would then require some kind of maintenance tool or, in terms of space 
technology, groundstation which would encapsulate this functionality in one entity. 

Most commonly, satellite groundstations consist of three parts (Figure 1): one or 
more computers, the necessary additional hardware for radio communications, and the 
software serving as a connection between those two parts. The software part of such a 
satellite groundstation is the scope of this thesis. 




Figure 1: Parts of a Satellite Groundstation and Satellite: 
A PC (1), the addditional hardware for radio 
communication (2), the Groundstation Software (3) and the 
satellite to communicate to (4). 
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The term Software Groundstation will be used in the following, referring to the 
software part of a satellite groundstation. This is done to indicate that the software is a 
major and separable part of the whole groundstation concept, and to distinguish it from 
the hardware part. 

The Software Groundstation is the only interface between users on earth and the 
spacecraft. As with most of all user interfaces, they should be adapted to human needs 
rather than human beings to user interfaces. Because many technical vehicles (such as 
satellites) are becoming more complex as they are becoming more powerful, the design of 
a satellite-to-human software interface likewise is more important. Whenever human 
interaction is needed for such vehicles, user friendliness should be a major concern 
before, while, and after the development phase of the software user interface. A user 
friendly design does not only make working with this interface more convenient, but also 
increases security and performance. 

C. OVERVIEW 

The following four chapters “Groundstation Requirements”, “Groundstation 
User’s Manual”, “Development Preparation Manual” and “Programmer’s Reference” 
present the reader with a climax in detailed description. The first two chapters explain 
necessary background information for users of the groundstation, whereas the last two 
chapters prepare a software developer to cope with the problem of enhancing the 
groundstation software. 

For reference purposes, the current source code of the groundstation is provided in 
the Appendix. 
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II. GROUNDSTATION REQUIREMENTS 



This chapter provides the information which finally led to the multiple decisions 
concerning the development and design of a suitable PANSAT Software Groundstation. 
The first section explains the need for a computer based (software) groundstation. The 
second section discusses the more detailed aspects of the groundstation based on those 
decisions. Finally, the third section allows a closer inspection on the facts that led to the 
decisions made concerning the software development environment of the PANSAT 
Groundstation. 

A. THE GROUNDSTATION AS A COMPUTER SOFTWARE 
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Figure 2: Advantages of a Software Groundstation 

Programming a computer requires detailed knowledge of the development tools, 
including a programming language as well as the programming and hardware 
environment. The lack of this knowledge often prevents one from the use of up-to-date 
software tools and computers; even though a software implementation in such an 
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environment would be most advantageous. The advantages of a Software Groundstation 
instead of other non software-based solution become apparent when just enumerating the 
advantages of software in general: 



• Software is flexible by definition: it is designed to be changed and adapted to a large 
variety of tasks. Whatever is imaginable to do with a specific hardware (computer, 
additional hardware) could be done by programming it. 

• Once a basic knowledge about programming is established, software development can 
go on relatively fast and cheap. Besides a standard PC and the development package, 
there is hardly any need for cost-intensive additional products. However, 
sophisticated software tools can be very expensive, and the time spent learning to 
program is a cost factor too. But normally the benefits of a software implementation 
will be worth the money and time spent for it, and sometimes there is not an 
alternative. 

• The flexibility of software applications gives the opportunity to program them user 
friendly, especially with a graphical oriented operating system such as Windows or 
Windows NT. 

• Use of a PC as a runtime platform ensures widespread use of the software that can run 
on it, thus making it attractive to all people who want to solve a specific problem with 
this software. Also, many people own a PC. 
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B. SOFTWARE AND DEVELOPMENT CONSTRAINTS 




Figure 3: Software and Development Environment Constraints Leading to 
the Design of the PANSAT Software Groundstation 

The software tools to be used when programming the PANSAT Software 
Groundstation were undetermined in the beginning. However, some of the requirements 
forced a decision: 
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• Existing software such as the operating system intended to be used onboard PANSAT 
was already available. It was written in C, so the programming language used for the 
Software Groundstation should be C (or C++, which incorporates C) also. However, 
this was not a must. 

• The programming language should be high-level and structurized, and it should be 
common for multipurpose tasks. Furthermore, it should allow a GUI method for user 
interaction; that is, a huge choice of visual controls. These constraints limited the 
amount of suitable languages to Object Pascal (as used in Borland’s Delphi ) and 
C++ (as used in Microsoft Visual C++ and Borland C++). Delphi offered a large 
variety of visual controls, whereas the C++ compilers stuck to somewhat standard 
controls. But because of the proven performance and the long period of presence on 
the market, C++ was chosen. 

• The operating system used for development should be the same for the runtime 
application version. This ensures data structure integrity and allows visual design for 
the application GUI. It also minimizes software incompatibility. The best and/or most 
commonly used operating systems enabling GUI programming are the Macintosh 
Finder and Microsoft Windows 3.x or Windows NT. Because of the common market 
acceptance for Windows as well as being the most common platform within the 
SSAG, this operating system was chosen. 

• The hardware development platform should normally be the same platform as for 
running an application (in contrary' to cross-platform development). This ensures 
hardware compatibility and minimizes software incompatibility between development 
and runtime application versions. Furthermore, a PC-based platform would be 
recommendable because of the widespread use of Intel®-80x86 processor series 
based computers. 

The first steps in designing a Software Groundstation were done in accordance to 
[Ref. 15, chapter IX. Ground Station Software Design ]. This description, however, 
involved too little detail to be useful for the actual design. In addition, the PANSAT 
Command Language (PCL) [Ref. 16] was subject to development after [Ref. 15] was 
written, and development software tools increased their capabilities during that time. So it 
turned out that almost none of the information in [Ref. 15] were suitable for the PANSAT 
Software Groundstation. 
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C. THE DEVELOPMENT ENVIRONMENT 



For the development of the PANSAT Software Groundstation (furthermore 
referred to as “groundstation”) several aspects have been taken into consideration. First, 
the groundstation should be a PC-based application using the Windows or Windows NT 
graphical user interface (GUI). Second, it should be mitten in a language familiar to the 
Space Systems Academic Group, so that it could be changed or enhanced once the core 
has been programmed. Third, this language should allow compatible access to the third- 
party developments, such as SCOS 1 . 

The choice was quite easy: the programming language should be C or C++. This 
decision determined the compiler: Microsoft Visual C++ Compiler (furthermore referred 
to as “MS VC”). There were other C++ compilers on the market, but as the author was 
familiar with this specific one, MS VC was chosen. The new version of MS VC runs only 
under Windows NT; thus, the development platform was determined. 

The GUI specifications for the groundstation needed a more advanced design than 
MSVC was capable to offer in the first place. However, MSVC’s capabilities could be 
enhanced by an additional interface programming package. WinWidgets/32 (WW) was 
chosen, especially because of its so-called “tabbed dialog” feature (a GUI feature which 
simplifies the display of multiple dialogs). In order to make MSVC work with WW, 
another dialog editor had to be purchased: Borland’s Resource Workshop (RW). The 
MSVC built-in AppStudio dialog editor does not feature the ability to graphically 
manipulate a GUI in connection with WW, wheras RW offered this possibility. 



1 SCOS: Spacecraft Operating System; the operating system used for PANSAT 
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III. GROUNDSTATION USER’S MANUAL 



This manual describes how the PANSAT Software Groundstation actually works. 
It consists of nine subsections, each representing one dialog of the groundstation which 
automatically appears when you start the application. Each of those dialogs represents 
one part of the PANSAT Command Language (PCL) with similar functionality. All eight 
dialogs (and a remaining embedding parent dialog) offer full access to all commands 
available with PCL. Finally, a short description of some auxiliary dialogs is presented. 

This manual assumes that you are already familiar with using a graphical oriented 
operating system such as Windows or Windows NT. 

A. THE “SCRIPTS” DIALOG 
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Figure 4: The Scripts Dialog 
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Within this Scripts dialog (Figure 4), the user is able to load, write, create and 
edit scripts and macros. Both may consist of one or more commands. A command is 
every order you give either to PANS AT or the Groundstation Software. A macro is one 
or more subsequent commands which are intended to be sent to PANS AT, that is, one or 
more command which is part of the PANSAT Command Language PCL. A script is one 
or more subsequent commands', this includes both PCL and language items not intended 
to be sent to PANSAT, but to control the Groundstation Software itself. Refer to Figure 4 
for a description of the features of this dialog: 



1. This Listbox represents the current Macro. It contains all commands in the execution 
sequence. All new commands are inserted before the highlighted command 
(drop_users in this case). When highlighted, the (next) entry allows insertion at 
the end of the Macro. 

2. This Listbox shows all available PCL commands, or, in case of Script editing (5), 
all available commands. 

3. These two Editfields show the command (left, drop_users in this case) and its 
parameters, if applicable (right, void in this case). The Erase Edit Line Button 
on the far right clears both Editfields. If a command takes parameters, a click in the 
right Editfield causes the specific dialog to appear in which the parameters of the 
command (left Editfield) can be edited. This will be one of the following dialogs: 
Mail, Memory, Low-Level, High-Level, Files or Task dialog. They are put into 
a special mode which allows only for setting or editing parameters of the command in 
the left Editfield. 

4. These two Radiobuttons determine the edit mode. They change the reaction on mouse 
clicks in area 1 and 2. The four buttons in area 6 indicate which mouse click produces 
which reaction, that is, left or right mousebutton. Refer to area 6 for explanation. 

5. These two Radiobuttons determine whether all commands are to be shown in areas 1, 
2 and 3 (Script) , or only PCL commands are to be shown (Macro). 

6. These four Pushbuttons allow Macro editing. Insert from Edit Line inserts the 
contents of 3 before the highlighted command listed in 1. Cut to Edit Line 
deletes the highlighted command line in 1 and pastes it into 3. Insert pastes the 
highlighted command of 2 in both 1 and 3, but only in case the command does not 
require parameters. However, if it requires parameters, the highlighted command in 2 



10 



is pasted only in 3. By pressing Edit, the highlighted command in 2 is pasted only to 
3, regardless of its parameter requirements. In Express Editing mode, the 
position of the Pushbuttons below the Listboxes 1 and 2 indicates which mousebutton 
(left or right) has to be clicked in 1 or 2 to obtain the same reaction as when clicking 
on one of the Pushbuttons. For example, click left in 1 to insert from Edit 
Line, click right in 1 to Cut to Edit Line. Same with 2: click left in 2 to 
Insert, or click right in 2 to Edit. 

7. These five Pushbuttons allow loading, saving and creating Macros as well as deleting 
Macros from disk. If a Macro has been changed, the user is prompted to save or save 
as it (depending on whether or whether not it already has a filename) before 
continuing with other actions. Furthermore, the default directory setting is 
automatically updated according to the Radiobutton setting 5. Scripts and Macros are 
stored in different directories as defined in the Preferences dialog (Figure 13), or 
as the appropriate section in the gnd . ini file tells. 



B. THE “TELEMETRY” DIALOG 

This dialog presents the current telemetry data received from PANS AT. It is not 
yet defined whether all available telemetry should be shown, or just parts of it. 
Furthermore, the storage format is not implemented yet; all telemetry shall be stored in an 
ODBC-compatible format. This implementation might alter the decision which part of the 
telemetry shall be presented in this dialog. In addition, the return structure (the 
SReturnCmd structure) is not implemented yet either. This task should be accomplished 
after the evaluation of the input structures. Therefore, the outward appearance of this 
dialog is postponed after the necessary preliminary actions are taken. 

The Preferences dialog (Figure 13) contains information about the location of 
telemetry data on a groundstation mass storage device. Telemetry data will be stored in 
this directory. 
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C. THE “MAIL” DIALOG 
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Figure 5: The Mail Dialog 



The Mail dialog handles the PANSAT mail capability. Mail could be regarded as 
a message with additional information: a from and to designator, the time the mail was 
sent, a subject and the text of the ASCII-message to be included in the mail. This dialog 
now offers the possibility to load, create and edit a message, and send it to PANSAT; to 
retrieve an already stored mail from PANSAT’s memory, read the message and the 
additional information, and save it to disk. The following visual controls allow mail 
handling (refer to Figure 5): 



1. This Listbox shows the current status of the PANSAT Mail Directory, as stored in 
recent telemetry. It contains the names of the mail files. Select a mail by highlighting 
its name with a mouse click. 

2. This Listbox shows the ASCII message of the mail. Carriage return is inserted 
automatically. 
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3. This Editfield shows the file name of the current mail. 



4. These four Editfields contain additional mail information, very similar to email. The 
From and To designator determine the sender and the recipient of the mail, the Date 
determines the time (day/month/year hourminute) of sending, and the Subject line 
should give an idea of what to expect from the message (as shown in 2). 

5. These five Pushbuttons trigger the PANSAT mail input/output. Get Mail retrieves 
the mail currently highlighted in 1 and shows it by filling up 2, 3 and 4. 
Get Directory updates the entries in 1 by retrieving the current mail directory 
from PANSAT. Delete Mail deletes the current selection in 1 by deleting the mail 
inside PANSAT, and Purge All Mail deletes all mail inside PANSAT. A 
Get Directory afterwards should reflect these actions. The Add Mail button lets 
the user edit his own mail in 2, 3 and 4. The button then changes to Send Mail. 
When done, the user presses the Send Mail button, and the mail is uplinked to 
PANSAT. 
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D. THE “MEMORY” DIALOG 



.Scripts Telemetry | Mail Memory } Low-Level f~Hiqh-Level j files } Tasjss 




Figure 6: The Memory Dialog 



The Memory dialog allows access to the various kinds of memories inside 
PANSAT. This is a very powerful feature, because every byte of PANSAT’s memory can 
be altered. The dialog is intended to serve as an emergency repair possibility only. By 
using the features of this dialog, the user must be aware of the fact that he could endanger 
the electronic life of PANSAT. 

The dialog consists of several parts (refer to Figure 6): 



1. This Grid contains 256 bytes of memory data in 16 rows. The first column Address 
shows the address of the memory contents as used in PANSAT. The second column 
Hex Data presents the memory data in hex format, 16 bytes per row, separated by 
whitespaces. The third column ascii Data shows the same 16 bytes as in 
Hex Data in ASCII format. The user may edit entries in Hex Data and 
ascii Data columns. However, altered data changes its color from black to red, but 
is not yet uplinked to PANSAT. The Scrollbar on the right side allows sequential 
reading of PANSAT’s memory contents; one click on the up or down arrow reads 16 
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bytes, one click above or below the slider reads 256 bytes. Dragging the slider with 
the mouse allows placing it to the desired memory range. In this case, the Address 
column contents change as the slider is dragged and shows the current 256-byte 
address block, but a 256 byte memory block is read from PANSAT only when the 
slider is released from dragging. 

2. These two Radiobuttons determine the display mode of the Address column 
contents in Grid 1 : either 20-Bit or Segment: Offset address display. 

3. These four Radiobuttons determine the memory which is shown in Grid 1: RAM, 
SRAM, ROM or FLASH memory. ROM cannot be edited. 

4. With these six Pushbuttons, the user can define which part of memory is to be 
accessed: memory in Mass Storage A or B, Analog Multiplexer A or B, the electric 
power supply (EPS) or the communications unit (RF System). In Figure 6, the 
Mass A (Mass Storage A) button is selected. 

5. With these two Pushbuttons, the user can determine whether to allow memory editing 
(Edit) or deny it (View). When denied (View), editing in Grid 1 becomes 
impossible. 

6. These two Editfields and two Pushbuttons reflect the current memory edit status of 
the memory block subject to editing . In the Bytes modified Editfield the amount 
of edited (red), but not yet uplinked data bytes is shown. The Bytes written 
Editfield shows the amount of edited bytes already written to PANSAT. The Cancel 
button abandons all changes to the memory block subject to editing and reverts its 
data bytes to the previous values. Thus, the Bytes modified entry becomes zero, 
and all red data in Grid 1 changes its value to the previous setting and becomes black. 
The Reset button sets the Bytes written entry to zero, but does not do anything 
else to memory data. 

7. These two buttons are the only ones which establish PANSAT I/O besides the 
Scrollbar in Grid 1. The Write Modified Bytes button writes all edited bytes 
shown red in Grid 1 as well as all edited bytes not in the current display of Grid 1 to 
the appropriate address and storage (as depicted in 1, 3 and 4) onboard PANSAT. The 
Re-Read visible Block button reads the 256 bytes currently visible in Grid 1 
from PANSAT and displays it. Any changes to the visible part of memory are 
abandoned by this action; thus, every edited (red) entry is updated with the current 



2 The memory data display is limited to 256 bytes in Grid 1, but the editable range can be much 
bigger (using the Scrollbar in Grid 1). The memory edit status as referred to in 6 includes all edited bytes 
(even if they are not visible in Grid 1) since the beginning of the edit session or the last uplink to PANSAT. 
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PANSAT memory contents and is shown in black, and the Bytes modified entry 
(6) is adjusted appropriately. This function is particularly useful when monitoring 
frequently changing memory contents. 



E. THE “LOW-LEVEL” DIALOG 
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Figure 7: The Low-Level Dialog 



The Low-Level dialog handles a multitude of settings onboard PANSAT which 
relate to close-to-hardware components control. The dialog is designed to provide a 
system overlook; thus it contains more visual controls than other dialogs. It falls into 
several parts (Figure 7): 



1. The Power Switches frame contains On-Off switches for multiple hardware 
sections onboard PANSAT: the communications unit (RF), the multiplexing units A 
and B (MUX A, MUX B), and the mass storage devices A and B (MStor A, MStor B). 
On means, the unit is provided with current, Off means, no current available for the 
unit. 
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2. The RF System frame falls into four parts: Receiver, Transmitter, 

Power Level and Transmit Mode. The Receiver and Transmitter Mixer 
settings are interdependent: when using Mix #5 for one of them, it is desirable that 
the other also uses Mix #5, and the same with Mix #6. However, it might turn out to 
be necessary to have different Mixer switches for receiving and transmitting. The first 
choice would be to use Mix #5 and LNA #1 for the receiver, and Mix #5 and 
HPA #3 for the transmitter. The receiver may use either low noise amplifier (LNA #1 
or LNA #2), and the transmitter may use either high power amplifier (HPA #3 or 
HPA #4). The numbering refers to bits in the control byte determining the receiver 
and transmitter settings. The Power Level Spin Control allows for settings in the 
range from 0 to 255 dB; however, the exact attenuation level is not determined yet. 
The Transmit Mode subframe allows for Spread Spectrum or No Spread 
Spectrum: settings for Narrow Band transmission and Binary Phased Shift Keying 
(BPSK) are set automatically. 

3. The Batteries frame contains settings for both batteries, A and B. The possible 
settings are Charge, Discharge and Online. During system start, it is possible 
(though not desirable) to have the batteries in none of those three modes. There are 
several combinations which are not possible: for each battery, it is prohibited to to 
Charge and be Online, or Discharge and be Online, or to Charge and 
Discharge, or to Charge and Discharge and be Online. Furthermore, it is not 
allowed that both batteries Charge at the same time, or that one battery Charges the 
same time the other battery is Online. 

4. The Temperature mux (Multiplexer) switch is not determined yet. 

5. The Watchdog Radiobuttons and Pushbuttons control the Digital Control System 
(DCS #1 or DCS #2). Each chosen DCS watchdog can be halted by pressing Stop, 
and it can be reset by pressing Reset. 

6. Each Digital Control System’s ROM can be rebooted by pressing the ROM Boot 
button. 

7. The SCOS Parameters frame allows for Read and Update 
Spacecraft Operating System’s Parameters. It is not yet defined how data transfer 
should be accomplished for this task. 

8. The PANS AT Clock frame contains an Editfield showing the current PANS AT 
system clock. In case it differs from ground time, the user may click the Set button to 
adjust PANSAT’s system clock to the Software Groundstation time. This should only 
be done directly after reading PANSAT’s system time via the Read button, because 
the time display is not updated automatically. 
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9. The Peripheral Control Bus (PCB) onboard PANSAT can be initialized inside the 
Peripheral Control Bus frame. This will reset it to a defined startup status. 



F. THE “HIGH-LEVEL” DIALOG 




Figure 8: The High-Level Dialog 



The Software Groundstation’s High-Level dialog (Figure 8) handles 
PANSAT’s Event Log and Time Tagged Commands feature. An Event Log is a list of 
time associated with an already executed command; Time Tagged Commanding allows 
remote command execution by associating a command to a certain time at which the 
command shall be executed. Thus, both lists contain the same time-to-command 
association. The Event Log is a report of what already happened, whereas the Time 
Tagged Command list holds commands for future execution. The following visual 
controls allow Event Log and Time Tagged Command handling: 
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1. This Grid contains PANSAT’s current Event Log. The list may display up to 12 time- 
to-command associations. The Time column contains the time in 
hours:minutes:seconds of PANSAT time and shows at which time the command 
depicted in the same row under the Command Executed column has been executed. 

2. This Grid holds all currently activated Time Tagged Commands. It is built up similar 
to Grid 1 . 

3. The Start Editfield contains the exact time and date the current Event Log has 
started. This time is given in hours:minutes:seconds day, month, year format. 

4. These three Radiobuttons determine what status PANSAT is set to as far as user 
access is concerned. Drop&Lockout executes the appropriate PCL commands and 
ceases eventual foreign user access and prevents new foreign users from logging into 
PANSAT. Lockout just prevents foreign users from logging on, and Unlock finally 
allows them to again log into PANSAT. 

5. The two Pushbuttons below Grid 1 refer to PANSAT’s Event Log. Read retrieves the 
current Event Log. Purge All deletes it from PANSAT’s memory, clears all Grid 1 
entries and resets the Start Editfield. 

6. These four Pushbuttons below Grid 2 handle Time Tagged Commanding (TTC). The 
Add. . . button adds a PCL command to the list. It invokes the Scripts dialog and 
puts it into a special mode so that only one PCL command (and its parameters, if 
applicable) may be selected. Then the command is pasted into Grid 2, where the user 
has to define the time he wishes the command to be executed. This time-to-command 
association then is sorted into Grid 2 (by time criterion). The Delete button erases 
the highlighted time-to-command association from PANSAT’s TTC list. The List 
button retrieves the currently activated list of PANSAT’s TTC. The Purge All 
button finally erases all currently activated entries from PANSAT’s TTC list. 
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G. THE “FILES” DIALOG 




Figure 9: The Files Dialog 

The Files dialog enables the user to access all file related functionality via PCL. 
A file is every portion of data associated with a filename by SCOS, and stored in SCOS- 
accessible memory. Mail, for example, is stored as a file. The following Files dialog 
items shall be implemented: 



1. This Listbox contains the current PANSAT filename list as known in recent 
telemetry. 

2. In this Listbox, the contents of the file named as shown in Editfield 3 is displayed. 

3. This Combobox under the Selected File (s) : Static Display contains a list of all 
recently read files. These files may be stored in the location identified by the IN 
section of the Preferences dialog (Figure 13), or the appropriate entry in the 
GND . INI file. 

4. These five buttons enable file reading, deleting and writing from and to PANSAT. 
Read File reads the highlighted file as depicted in 1 and displays its contents and 
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name in 2 and 3. Read Directory retrieves PANSAT’s current file directory and 
places this list in 1. Delete File erases the highlighted filename entry from 
PANSAT’s file directory, and Purge All Files erases the entire filename list from 
PANSAT’s file directory. Write File finally writes a file to PANSAT’s mass 
storage device and creates an entry in PANSAT’s file directory. This file shall be 
loaded from a groundstation storage device to 2, from where it could be uplinked via 
Write File. The appropriate buttons for loading a file from a groundstation storage 
device are not implemented yet. The files intended to uplink to PANS AT could be 
stored in the location identified by the OUT section of the Preferences dialog 
(Figure 13), or the appropriate entry in the GND . INI file. 



H. THE “TASK” DIALOG 




Figure 10: The Tasks Dialog 

The Tasks dialog as depicted in Figure 10 enables the user to perform task 
handling. A task is a PANS AT executable which is added to the SCOS-maintained task 
list. With SCOS, a Priority-based Round Robin task scheduling method is used. The 
following visual control reflect this functionality: 
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1. This Grid contains task information for tasks currently recognized by SCOS. Five 
colums provide the necessary task information. The first column contains Checkboxes 
showing an activated (crossed) or deactivated (not crossed) status. The second column 
Task displays the task name; the third, Status, the current task status: running, 
waiting, and screech. Refer to [Ref. 17] for further information. The fourth column 
Pri shows the task priority in four possible levels: 0 is highest, 3 is lowest ([Ref. 17, 
page 1 1]). The fifth and last column, Size, depicts the length of the task in bytes. It 
may be as long as 2 16 -1= 65535 bytes. Only the first column (activation status) and 
the Pri column allow for user editing. 

2. This Grid contains all files stored in the location referenced by the Task List 
section of the Preferences dialog (Figure 13). The Software Groundstation 
considers all files in this directory as valid PANSAT executables. Filename and file 
size are shown in the appropriate columns. 

3. This Editfield contains the name of the highlighted task from Grid 2. 

4. These three Radiobuttons determine what action is executed when pressin the Add 
button 5. Add & Start Task & Get List lets the Add button perform all these 
three actions; the Add & Get List and Add Radiobuttons let the Add button 
perform actions respectively. 

5. The Add Pushbutton uplinks the task with the taskname as shown in 3 to PANSAT’s 
Task List. Depending on the settings in 4, this button behaves different. When 
Add & Start Task & Get List is activated, a click on the Add button is the 
same as adding a new task to PANSAT’s task list, clicking its activation checkbox in 
1 and pressing the Get Tasklist button. When Add & Get List is activated, a 
click on the Add button is the same as adding a new task to PANSAT’s task list and 
pressing the Get Tasklist button. If only the Add radiobutton is activated, a click 
on the Add button is just the same as adding a new task to PANSAT’s task list. 

6. The Get Tasklist button retrieves the current task list from PANSAT, and the 
Delete Task button erases the task currently highlighted in 1 from PANSAT’s task 
list. 

7. The Load. . . button allows loading PANSAT executables from other locations than 
shown in the Preferences dialog in the Task List Editbox by bringing up an 
appropriate Common Dialog Box. 
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I. THE EMBEDDING MACRO/STATUS DIALOG 



All dialogs explained above are embedded in a 
main dialog template which extends the Software 
Groundstation functionality by a Macro List (Figure 11) 
and a Status Display (Figure 12). 

The Macro List at the far right side of the main 
dialog contains the following visual controls: 



1 . Up to 1 5 Macros may be accessed by the pushbuttons 
0 to 15. By clicking these buttons with the left 
mousebutton, the macro stored in this place may be 
executed. Macro language allows recursive execution 
of macros (Macro A invokes Macro B, and Macro B 
invokes Macro A, ...). By clicking one of these buttons 
with the right mousebutton, the Macro dialog appears 
(to be determined). From within this dialog, the user 
may load a new macro, and give it a name other than 
just a number, which then will be displayed instead of 
the number as shown in Figure 1 1. If not every macro 
button is occupied, the macro list is limited to the 
current amount of macros. 
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Figure 11: The Macro List 



2. The . . . button switches to the following selection of 15 macros from the macro list, 
or, if the end of the list is reached, to the first 1 5 macros. The macro list can be much 
longer than just 15 macros. This button allows for switching in portions of 1 5 macros. 

The Status Display on the bottom of the main dialog contains the following items: 



1. The Send and Receive color frame. When sending (that is, transmitting data 
through the serial port), the dark red color turns to bright red. When receiving 
(obtaining data from the serial port), the dark blue color turns to bright blue. 
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Figure 12: The Status Display 
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2. The System Time & Date Editfield reflects the current Software Groundstation 
internal time and date. 

3. This short period timer can be started by pressing start or halted by pressing 
Pause. When pressing start while pausing, the timer is reset to 00:00:00. Pressing 
Pause when pausing resumes the timer. This timer may become particularly 
important in order to achieve a time perception of how long PANSAT will be above 
the earth horizon. It could be started when first establishing contact with the satellite 
and thus measure the communication period. 

4. The Log Combobox reflects all actions done with the Software groundstation. It 
contains Event Log - like entries which then are stored under a username-specific 
filename according to the login (refer to Figure 14) in the directory referenced to by 
the User Log Editlist entry of the Preferences dialog (Figure 13). Three 
Pushbuttons determine what type of user action is shown in the Log Combobox: pcl 
means that only PCL commands are shown in the Log; mcl means, all commands 
(including PCL commands and the Software Groundstation commands as used for 
the Script language) are shown in the Log. User then advises the Log only to reflect 
all Script language commands without the PCL commands. 



J. THE LOGIN AND PREFERENCES DIALOG 
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Figure 13: The Preferences Dialog 



The Preferences dialog as 
shown in Figure 13 reflects the contents 
of the GND . INI file. Every time it is 
invoked by the appropriate menu item, 
the GND . ini file is read. When clicking 
OK, the current contents of the dialog is 
saved to GND. INI. Cancel abandons 
eventual changes. 

The Editfields of this dialog 
determine the storage directory for 
various groundstation settings. Refer to 
the description of the appropriate dialog 
above for further details. 
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The Login dialog as shown in Figure 
14 must be invoked before any 
communication with PANSAT may be 
established. Both a user login and a password 
must be provided. An internal user list then 
recognizes the user status. The groundstation 
application divides into four of them: 

System Administrator (all functionality, 
including password setting for other users), Super User (all PANSAT-related 
functionality). Intermediate User (all PANSAT-related functionality, except Low-Level 
and Memory dialog features), and Normal User (only Mail dialog features). 



PANSAT Groundstation User Login 



Please enter your login and password 
Login: [jbartschat 



Password: BESS 



Ok 



Cancel 



Figure 14: The Login Dialog 
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IV. DEVELOPMENT PREPARATION MANUAL 



This preparation manual is intended for use by a developer who wants to continue 
developing either the groundstation software or create an application using a similar 
environment. It consists of three sections. The first section describes the necessary steps 
of installing and configuring the various software tools related to the development of the 
PANSAT Software Groundstation. The second section contains a brief explanation of 
basic programming knowledge necesssary to understand not only how the groundstation 
software is structured, but also how the Windows operating system related applications 
are implemented in general. The third section finally puts the first two together and 
explains briefly, how the various software tools may assist you in developing an arbitrary 
application taking the groundstation software as an example. 

The following will be very useful for programmers who want to develop their 
own applications in a similar environment to the one used for the PANSAT Software 
Groundstation, which could be considered as a typical Windows application. It assumes 
you are already familiar with at least the “Groundstation Requirements” chapter. 

A. INSTALLATIONS AND CONFIGURATIONS 

This section describes the necessary steps of installing and configuring the various 
software tools related to the development of the PANSAT Software Groundstation. 

1. Basic Installations 

After successfully installing Windows NT 3.5 and MSVC 2.0, WinWidgets (WW) 
and Resource Workshop (RW) were installed. Following the automated installation, these 
tools could still not interact. The following steps describe how to access RW from within 
MSVC, and how to tell MSVC, RW and the current application to work properly with 
WW. 
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2. Connecting the Compiler to the Resource Workshop 



Start MSVC. Under the Tools menu item, choose Customize... and the 
tabbed dialog Tools. Enter the path to the Resource Workshop as you installed it on the 
harddisk under the Command entry, or browse for Resource . exe. Enter Workshop or 
another more convenient name under the Menu Text entry. Under Arguments, enter 
$RC and every time you start RW, the current *.RC file containing resource information 
from your application will be passed to RW and automatically displayed by it. Under 
Initial Directory, enter $ProjDir and RW knows that the current resource file 
could be found in the project directory created by MSVC. For a more detailed description 
of all possible features, press the Help button. 

Now affirm all your actions and leave the Tools dialog. The Tools menu bar 
should now contain the new entry Workshop (or any other text you wrote into the Menu 
Text section of the Tools dialog). 

3. Connecting the Compiler and the Application to 
WinWidgets 

Once you have created an application skeleton with MSVC, you are ready to 
connect MSVC and this application to WinWidgets. If you do not know how to create an 
application skeleton, refer to “Programming with the Microsoft Visual C++ Compiler”. 

If you plan to use WW with more than just one application, it makes sense to put 
all necessary changes in a text file. This file could look like the following: 
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C/C++ Preprocessor AND Resources: 
d : \widgets\include ,d: \widgets\cpp\ include 



Link Input: 

d: \widgets\lib\xtbl32 . lib d: \widgets\lib\widge32 . lib 

Initlnstance Q : 

Widgetslnit ( ) ; 

XTablelnit () ; 

App . h : 

#include "mfcwidg.h" 

#include "mfcxtbl.h" 

Load this file into a text editor or to a temporary opened new text window under 
MSVC. The four paragraphs contain all the information you need to paste into MSVC 
settings and/or your application. This file assumes that you have installed WW in the 
widgets drawer of your D : drive. If not, change the appropriate lines in the above text. 

Invoke MSVC and the Project/Settings. . . dialog. Choose the C/C++ tab 
and from the appearing Category drop list, choose Preprocessor. Copy the line 
following “C/C++ Preprocessor AND Resources:” into the clipboard and paste it into the 
Additional Include Directories edit box. Now choose the Resources tab in 
the settings dialog and paste the same string into the Additional include 
Directories edit box of this tab also. 

Now choose the Link tab and from the appearing Category drop list, choose 
Input. Copy the line following “Link Input:” into the Object /Library Modules edit 
box. 

Open the application file of your previously created project. If you named your 
project XYZ, then the application file of your project is named XYZ . cpp and could be 
found in the drawer XYZ (unless you specified otherwise; this is the default setting). In 
XYZ. cpp. you find a method called Initlnstance. Copy the lines following 
“Initlnstance():” at the beginning of the Initlnstance method. 

Open the corresponding include-file, that is, the include file named XYZ.h. It 
contains application- wide declarations and definitions and is included in every *.cpp file 
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